Shareware Grab Bag

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / zdoc0529.arc / ZDOC < prev

Wrap

Text File | 1987-05-29 | 29.4 KB | 730 lines

_______________________________________________________________________________ PROGRAM: DSZ.EXE Version 05/29/87 PURPOSE: Utility to Transfer Files to/from Remote USAGE: Ctrl-Break to Abort DSZ [port n] [speed s] [z p_#] [restrict] command [-options] [filename(s)] _______________________________________________________________________________ note: Use MODE COM1:12,N,8,1,- in AUTOEXEC.BAT to initialize Port. DSZ reads the DOS environment variable DSZPORT=n to open COMn: DSZ sets ERRORLEVEL 0 if transfer successful (and 1 if not). _______________________________________________________________________________ Receive File(s) from Remote Protocol: DSZ rx -y Filename.ext Xmodem/Sum Ymodem/Sum DSZ rc -y Filename.ext Xmodem/CRC Ymodem/CRC DSZ rc -gy Filename.ext Ymodem-G DSZ rb -y Ymodem-Batch DSZ rb -gy Ymodem-G Batch DSZ rz -y Zmodem-Batch _______________________________________________________________________________ Transmit File(s) to Remote Protocol: DSZ sx Filename.ext Xmodem/CRC Xmodem/Sum DSZ sx -k Filename.ext Ymodem/CRC Ymodem/Sum DSZ sx -k Filename.ext Ymodem-G DSZ sb -k Filename(s) Ymodem-Batch DSZ sb -k Filename(s) Ymodem-G Batch DSZ sz Filename(s) Zmodem-Batch _______________________________________________________________________________ note: Xmodem uses 128-Byte Packets and CRC-16 error checking. Ymodem uses 1024-Byte Packets and CRC-16 error checking. Use SET 1:0,4:2,5:0,7:8,12:0 to configure TeleNet for Ymodem. note: Zmodem uses free-flowing Packets and CRC-32 error checking. XON/XOFF - Handshaking required for Zmodem-Batch Transfers. Use SET 1:0,4:2,5:1,7:8,12:1 to configure TeleNet for Zmodem. note: Ymodem-G uses free-flowing Packets and no error checking. RTS/CTS - Handshaking required for Ymodem-G Transfers. Use Microcom Network Protocol "MNP" Modems for Ymodem-G. _______________________________________________________________________________ Command Line Switches Defaults: CON Redirect Display Output to CON: Standard Out port n Open DOS COMn: for data inp/out. Port "COM1:" speed s Set Baud 300 1200 2400 4800 9600 Current Baud restrict (Receiver) to current Directory Unrestricted d Direct Connect No Carrier Detect DCD Checking handshake on Enable RTS/CTS Hardware Handshake XON/XOFF used _______________________________________________________________________________ Command Line Parameters Usage: p Display Numeric Parameter Settings (all) pa2000 Adjust Timers for CPU Clock Speed (all) po1 Use CRC-16 Error Checking Method rb sb pS15 Timeout - Wait for XON from Remote (all) pv0 Display Debugging Information -pV2 (all) pz0 Reset Zmodem Time - Zone Standards rb sb z p Display Numeric Parameter Settings rz sz z pL1024 Force Zmodem Packet Length to 1-Kb sz z C11 Use CRC-32 Error Checking Method rz z e0 Escape Control Characters in Data rz sz z lx Wait for ACK after x bytes (def=0) sz z n0 Transfer File if Newer or Longer sz z p50 Receiver Timeout - Gaps in Packets rz z s15 Timeout - Wait for XON from Remote rz sz z t100 Receiver Timeout - Wait for Sender rz z T600 Sender Timeout - Wait for Receiver sz z Z0 Reset Zmodem Time - Zone Standards rz sz _______________________________________________________________________________ Command Line Options Usage: -y Overwrite Existing File rx rc rb rz -k Transmit 1-Kb Packets sx sb -g Ignore ACK/NAK Checking rc rb .... see File: ZCOMMDOC.ARC ..... _______________________________________________________________________________ File Transfer Performance 100Kb Test File XMODEM YMODEM ZMODEM YMODEM-G Protocol Overhead Characters 4803 603 3600 503 Transfer Protocol Round Trips 803 103 5 5 (direct) Trip Time ... 40ms 32.12s 4.12s 0.2s 0.2s Transfer Time (direct) 40ms 925s 862s 883s 857s (netwrk) Trip Time ... at 5s 4015s 515s 25s 25s Transfer Time (netwrk) at 5s 5761s 1373s 918s 882s DSZ - PCBoard File Transfers XMODEM YMODEM ZMODEM YMODEM-G TeleNet Benchmarks: 48cps 96cps 113cps 118cps Relative Efficiency: 40% 80% 95% 98% _______________________________________________________________________________ Performance Considerations (1) Recommended System Timing is: pa2000 for 8088-5 Mhz pa4000 for 8086-8 Mhz pa6000 for 80286-8 Mhz (2) The Receiver should initiate Xmodem, Ymodem, and Ymodem-G. (3) The Sender should initiate Zmodem-Batch. After beginning, the Receiver can select to DownLoad File(s) with Zmodem or Ymodem-G Batch protocols - the Sender will adjust. (4) During "free-flowing" Zmodem and Ymodem-G DownLoads, DSZ writes data to the Disk in 1024-Byte Blocks. Performance improves using a RamDisk; above 2400 Baud it is essential. (5) The TeleNet TERMINAL=D1 at LogOn increases transfer speed by suppressing NUL characters in the data stream. (6) The TeleNet SET 1:0,4:2,7:8 command configures PCPursuit for High-Speed, Binary File Transfers: 1:0 - Disables <cr>@<cr> escape to '@' Prompt 4:2 - Minimizes Network Transmission Delays 7:8 - Configures [Break] escape to '@' Prompt (7) The TeleNet SET 5:1,12:1 command establishes Handshaking between DSZ and the TeleNet PAD. It should only be used for Zmodem Transfers. Xmodem & Ymodem are not "free-flowing" Protocols, and so require no Flow Control: 5:1 - Enables XON/XOFF Flow Control from DSZ to PAD 12:1 - Enables XON/XOFF Flow Control from PAD to Host _______________________________________________________________________________ note: Connect to PCPursuit Target City before using "SET" commands. _______________________________________________________________________________ ┌─────┐ ╔═══╡ SAT ╞═══╗ ║ └─────┘ ║ ║ ║ XON / XOFF ║ TELENET ║ XON / XOFF ┌─────────┴─────────┐ ║ ║ ┌─────────┴─────────┐ ┌─────┐ ┌─────┐ ┌──╨──┐ ┌──╨──┐ ┌─────┐ ┌─────┐ │ TTY ╞═══════╡ MDM ╞═══════╡ PAD │ │ PAD ╞═══════╡ MDM ╞═══════╡ BBS │ └─────┘ RS232 └─────┘ 1200B └─────┘ └─────┘ 1200B └─────┘ RS232 └─────┘ └──┬──┘ └──┬──┘ └──┬──┘ └──┬──┘ RTS/CTS MNP outdial RTS/CTS Optimization of TeleNet - Zmodem _______________________________________________________________________________ CED Syntax - Running DSZ from TTY DOS Shell SET COMSPEC=d:\COMMAND.COM (DOS Shell path) (__DOS v3.X) SET DSZPORT=1 (DSZ Port COM1:) (__DOS v3.X) CED SYN TTY d:\telix.exe o q start.scr (Telix v2.X) CED SYN PRO d:\procomm (ProComm v2.X) CED SYN SST d:\qmodem (DSZ integrated) (Qmodem v3.X) CED SYN BD1 d:\boyan (DSZ integrated) (Boyan vD1) CED SYN GTO d:\gto (DSZ integrated) (PowerComm v12.X) RX d:\dsz.exe rc -y %1^EXIT Xmodem/CRC SX d:\dsz.exe sx %1^EXIT RY d:\dsz.exe rc -y %1^EXIT Ymodem/CRC SY d:\dsz.exe sx -k %1^EXIT RG d:\dsz.exe handshake on rc -gy %1^EXIT Ymodem-G SG d:\dsz.exe handshake on sx -k %1^EXIT RB d:\dsz.exe rb -y^EXIT Ymodem-Batch SB d:\dsz.exe sb -k %1 %2^EXIT RGB d:\dsz.exe handshake on rb -gy^EXIT Ymodem-G Batch SGB d:\dsz.exe handshake on sb -k %1 %2^EXIT RZ d:\dsz.exe rz -y^EXIT Zmodem-Batch SZ d:\dsz.exe z pL1024 sz %1 %2^EXIT _______________________________________________________________________________ (CED SYN) File Transfer Commands at DOS Prompt Xmodem/CRC RX d:\filename.ext SX d:\filename.ext Ymodem/CRC RY d:\filename.ext SY d:\filename.ext Ymodem-G RG d:\filename.ext SG d:\filename.ext Ymodem-Batch RB SB d:\filename(s) Ymodem-G Batch RGB SGB d:\filename(s) Zmodem-Batch RZ SZ d:\filename(s) _______________________________________________________________________________ File Transfer Protocols ╔═══════════════════════════════════════════════════════════════════════════╗ ║ ║ ║ XMODEM/SUM File Transfer Protocol ║ ║ ║ ║ SENDER RECEIVER ║ ║ ║ ║ NAK ║ ║ NAK ║ ║ NAK ║ ║ STX 01 FE Data[128] SUM SUM ║ ║ ACK ║ ║ STX 02 FD Data[128] SUM SUM ║ ║ NAK ║ ║ STX 02 FD Data[128] SUM SUM ║ ║ ACK ║ ║ STX 03 FC Data[128] SUM SUM ║ ║ ACK ║ ║ STX 04 FB Data[100] CPMEOF[28] SUM SUM ║ ║ ACK ║ ║ EOT ║ ║ ACK ║ ║ ║ ║ ║ ╚═══════════════════════════════════════════════════════════════════════════╝ ╔═══════════════════════════════════════════════════════════════════════════╗ ║ ║ ║ XMODEM/CRC File Transfer Protocol ║ ║ ║ ║ SENDER RECEIVER ║ ║ ║ ║ C ║ ║ C ║ ║ C ║ ║ STX 01 FE Data[128] CRC CRC ║ ║ ACK ║ ║ STX 02 FD Data[128] CRC CRC ║ ║ NAK ║ ║ STX 02 FD Data[128] CRC CRC ║ ║ ACK ║ ║ STX 03 FC Data[128] CRC CRC ║ ║ ACK ║ ║ STX 04 FB Data[100] CPMEOF[28] CRC CRC ║ ║ ACK ║ ║ EOT ║ ║ ACK ║ ║ ║ ║ ║ ╚═══════════════════════════════════════════════════════════════════════════╝ ╔═══════════════════════════════════════════════════════════════════════════╗ ║ ║ ║ YMODEM/CRC File Transfer Protocol ║ ║ ║ ║ SENDER RECEIVER ║ ║ ║ ║ C ║ ║ C ║ ║ C ║ ║ SOH 01 FE Data[1024] CRC CRC ║ ║ ACK ║ ║ SOH 02 FD Data[1024] CRC CRC ║ ║ NAK ║ ║ SOH 02 FD Data[1024] CRC CRC ║ ║ ACK ║ ║ SOH 03 FC Data[1024] CRC CRC ║ ║ ACK ║ ║ SOH 04 FB Data[1000] CPMEOF[24] CRC CRC ║ ║ ACK ║ ║ EOT ║ ║ ACK ║ ║ ║ ║ ║ ╚═══════════════════════════════════════════════════════════════════════════╝ ╔═══════════════════════════════════════════════════════════════════════════╗ ║ ║ ║ YMODEM-G File Transfer Protocol ║ ║ ║ ║ SENDER RECEIVER ║ ║ ║ ║ G ║ ║ G ║ ║ G ║ ║ SOH 01 FE Data[1024] CRC CRC ║ ║ SOH 02 FD Data[1024] CRC CRC ║ ║ SOH 02 FD Data[1024] CRC CRC ║ ║ SOH 03 FC Data[1024] CRC CRC ║ ║ SOH 04 FB Data[1000] CPMEOF[24] CRC CRC ║ ║ EOT ║ ║ ACK ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ╚═══════════════════════════════════════════════════════════════════════════╝ ╔═══════════════════════════════════════════════════════════════════════════╗ ║ ║ ║ YMODEM-BATCH File Transfer Protocol ║ ║ ║ ║ SENDER RECEIVER ║ ║ ║ ║ C ║ ║ C ║ ║ SOH 00 FF FILENAME.EXT NUL[116] CRC CRC ║ ║ ACK ║ ║ C ║ ║ SOH 01 FE Data[1024] CRC CRC ║ ║ ACK ║ ║ SOH 02 FD Data[1024] CRC CRC ║ ║ ACK ║ ║ SOH 03 FC Data[1000] CPMEOF[24] CRC CRC ║ ║ ACK ║ ║ EOT ║ ║ ACK ║ ║ C ║ ║ SOH 00 FF NUL[128] CRC CRC ║ ║ ACK ║ ║ ║ ╚═══════════════════════════════════════════════════════════════════════════╝ ╔═══════════════════════════════════════════════════════════════════════════╗ ║ ║ ║ YMODEM-G Batch File Transfer Protocol ║ ║ ║ ║ SENDER RECEIVER ║ ║ ║ ║ G ║ ║ G ║ ║ G ║ ║ SOH 00 FF FILENAME.EXT NUL[116] CRC CRC ║ ║ G ║ ║ SOH 01 FE Data[1024] CRC CRC ║ ║ SOH 02 FD Data[1024] CRC CRC ║ ║ SOH 03 FC Data[1024] CRC CRC ║ ║ SOH 04 FB Data[1000] CPMEOF[24] CRC CRC ║ ║ EOT ║ ║ ACK ║ ║ G ║ ║ SOH 00 FF NUL[128] CRC CRC ║ ║ ACK ║ ║ ║ ║ ║ ║ ║ ╚═══════════════════════════════════════════════════════════════════════════╝ ╔═══════════════════════════════════════════════════════════════════════════╗ ║ ║ ║ ZMODEM - Batch File Transfer Protocol ║ ║ ║ ║ SENDER RECEIVER ║ ║ ║ ║ rz CR ║ ║ ZRQINIT(0) XON ║ ║ ZRINIT ║ ║ ZFILE ║ ║ ZRPOS ║ ║ ZDATA ║ ║ Data[1024] CRC-32 ║ ║ Data[1024] CRC-32 ║ ║ Data[1024] CRC-32 ║ ║ ZEOF ║ ║ ZRINIT ║ ║ ZFIN ║ ║ ZFIN ║ ║ OO ║ ║ ║ ║ ║ ║ ║ ╚═══════════════════════════════════════════════════════════════════════════╝ _______________________________________________________________________________ Examples of Options for File Transfers Reference: File ZCOMMDOC.ARC 04/28/87 Note: options + n y p are mutually exclusive. + Append Data to Existing File rx rc rb rz + Append Data to Existing File sx sb sz EXAMPLE: rz -+ EXAMPLE: sz -+ ONAME=master.log *.log Appends Sender's *.log Files to Receiver's master.log n Transfer if Newer or Longer rb rz n Transfer if Newer or Longer sb sz EXAMPLE: rz -n EXAMPLE: sz -n *.log Transfers all *.log Files Receiver does not have y Overwrite Existing File rx rc rb rz y Overwrite Existing File sz EXAMPLE: rz -y (do not use if restricted) EXAMPLE: sz -y *.log Transfers all *.log Files to Receiver _______________________________________________________________________________ Note: options a b r are mutually exclusive. a Convert File to ASCII Format rz rc rb rz a Convert File to ASCII Format sz EXAMPLE: rz -a EXAMPLE: sz -a MESSAGE.TXT Converts File MESSAGE.TXT to Receiver ASCII Format b Inhibit ASCII File Conversion sz EXAMPLE: sz -b PROGRAM.EXE Transfers File PROGRAM.EXE to Receiver BINARY Format r Recover Interrupted Transfer rz r Recover Interrupted Transfer sz EXAMPLE: rz -r EXAMPLE: sz -r PROGRAM.EXE Resumes an interrupted File Transfer _______________________________________________________________________________ c Use CRC-16 error checking rx EXAMPLE: rx -c filename.ext Uses CRC-16 error checking E Escape only Ctrl-X [CAN] sz EXAMPLE: sz -E filename.ext All other characters are sent to Receiver e Escape only Ctrl- characters sz EXAMPLE: sz -e filename.ext All other characters are sent to Receiver f Send Full PathName to Receiver sb sz EXAMPLE: sz -f d:\path\*.ARC File(s) are are sent to Receiver's d:\path g Ignore ACK/NAK Block Checking rx rc rb EXAMPLE: rb -g EXAMPLE: rc -g filename.ext Receives File Ymodem-G Protocol k Use 1-Kb Packets (Blocks) sx sb EXAMPLE: rx -k filename.ext Transfers File Ymodem/CRC-Sum v Verbose mode - display info rx rc rb rz v Verbose mode - display info sx sb sz EXAMPLE: rz -vv EXAMPLE: sz -vv MESSAGE.TXT Displays File being transferred _______________________________________________________________________________ Options: + Append to existing destination file (Z) a (ASCII) change NewLine to CR/LF b Binary file transfer override c use 16-bit CRC (X) d Change '.' to '/' in pathnames (B/Z) e Escape all control characters (Z) E Escape Ctrl-X CAN character (Z) f send Full pathname (B/Z) k Send 1024 byte packets (X/B) L N Limit subpacket length to N bytes (Z) l N Limit frame length to N bytes (l >= L) (Z) n send file if Newer or Longer (Z) N send file if Older (Z) o Use 16 bit CRC instead of 32 bit CRC (Z) p Protect existing destination file (Z) r Resume/Recover interrupted file transfer (Z) q Quiet (no progress reports) u Unlink file after transmission vv Verbose - debugging information X XMODEM protocol - send no pathnames y Yes, overwrite existing file (Z) Y Yes, overwrite only if file exists (Z) _______________________________________________________________________________ DSZ.EXE Written by Chuck Forsberg 05/29/87 Voice: (503) 621-3406 Data: (503) 621-3746 Copyright 1987 Omen Technology, Inc. Box 4681, Portland OR 97208 _______________________________________________________________________________ ZDOC Written by Steve Shelton San Francisco _______________________________________________________________________________